Release 10.1A: OpenEdge Development:
ADM Reference

remoteSendRows

A stateless version of sendRows that does no processing but runs sendRows to pass all parameters except for the context and returns the RowObject table as an output parameter to the caller that has the new batch of records created in sendRows.

Location: sbo.p

Parameters:

INPUT-OUTPUT pcContext

CHR(3) separated list of propCHR(4)value pairs. INPUT is the current context and OUPTPUT is the new context. The INPUT and OUTPUT can have different properties.

INPUT piStartRow

The RowNum value of the record to start the batch to return. Typically piStartRow is a flag with a value of ? that indicates pcRowIdent should be used instead of piStartRow.

INPUT pcRowIdent

The RowIdent of the first record of the batch to return. Can also be FIRST or LAST to force the retrieval of the first or last batch of RowObject records.

INPUT plNext

Determines whether serverSendRows should start on the next record instead of what is indicated by piStartRow or piRowIdent. If TRUE, serverSendRows should start on the next record instead of what is indicated by piStartRow or piRowIdent.

INPUT piRowsToReturn

The number of rows in a batch.

OUTPUT piRowsReturned

The actual number of rows returned. This number is either the same as piRowsToReturn or less if there are not enough records to fill the batch.

OUTPUT pcMessages

Used for error messages.

Notes:

If piStartRow is not 0 or ?, then pcRowIdent is ignored. plNext is ignored if pcRowIdent is FIRST or LAST. The most common use of piRowsReturned is to indicate that the entire result list has been returned when it is less than piRowToReturn.
The object should only be started persistently before this is called and not initialized because initializeObject is run after the context has been set.
The caller is responsible for destroying the object.
For more details, see synchronizeProperties and genContext.